運算子庫:硬體平台
該 AppletProperties運算子沒有輸入,也沒有 輸出。它負責控制 Applet 以及電路板硬體的設定。
該運算子提供一組參數,用以 描述該小程式。其中部分值由使用者定義,其餘則由系統自動 產生。
此運算子在每個設計中皆為必備, 並由 `VisualApplets` 自動實例化。此運算子無法被刪除。
| 適用於硬體平台 |
|---|
| imaFlex 2 Dual 100 |
| imaFlex CXP-12 Penta |
| imaFlex CXP-12 Quad |
| mE5 marathon VCLx |
| mE5 marathon VCL |
| mE5 marathon VCX-QP |
| mE5 marathon VF2 |
| LightBridge VCL |
| mE5 ironman VQ8-CXP6D |
| mE5 ironman VQ8-CXP6B |
| mE5 ironman VD8-PoCL |
![]() |
可用參數 |
|---|---|
|
AppletProperties運算子為每個硬體平台提供一套 特定的參數。 以下參數說明指出哪些硬體平台支援哪些 參數。若未指定任何限制,則表示該參數在所有 平台上均受支援。 |
| VisualApplets 版本(所有平台) | |
|---|---|
| Type | 靜態讀取參數 |
| Default | 不適用 |
| Range | 不適用 |
|
所使用的VisualApplets 版本的版本號。 |
|
| 專案名稱(所有平台) | |
|---|---|
| Type | 靜態讀取參數 |
| Default | 不適用 |
| Range | 不適用 |
|
如選單中所示的專案名稱 「設計」選單中的 「屬性」選項。 |
|
| AppletVersion(所有平台) | |
|---|---|
| Type | 靜態讀取參數 |
| Default | 不適用 |
| Range | 不適用 |
|
版本如「設計」選單中的 「屬性」選單項目所示。 |
|
| AppletVendor(所有平台) | |
|---|---|
| Type | 靜態讀取參數 |
| Default | 不適用 |
| Range | 不適用 |
|
直接在該運算子的 「模組」屬性對話方塊中,您可以輸入 關於 Applet 供應商的資訊。 |
|
| AppletAuthor(所有平台) | |
|---|---|
| Type | 靜態讀取參數 |
| Default | 不適用 |
| Range | 不適用 |
|
直接在該運算子的 「模組」屬性對話方塊中,您可以輸入 Applet 作者的相關資訊。 |
|
| BuildTime(所有平台) | |
|---|---|
| Type | 靜態讀取參數 |
| Default | 不適用 |
| Range | 不適用 |
|
BuildTime 參數是一串自動生成的字串,顯示 該小程式何時被建置(最近一次產生網表的日期與時間)。 該參數值僅在「Framegrabber SDK 」中可見。下圖 顯示了該字串的格式: ![]() |
|
| AppletUid(所有平台) | |
|---|---|
| Type | 靜態讀取參數 |
| Default | 不適用 |
| Range | 不適用 |
|
Applet 的唯一識別碼。每次建立新版本時,都會產生一個新的識別碼(若已 設定先決條件檢查)。 |
|
| FrontGpiPullControl03 / FrontGpiPullControl47(imaFlex 2 Dual 100 平台) | ||||
|---|---|---|---|---|
| Type | 動態、靜態寫入參數 | |||
| Default | PullUp | |||
| Range | {PullUp, PullDown} | |||
|
此參數用於控制前插槽 GPI 訊號的上拉與下拉電阻(20 kOhm), 無論其配置為 差分或單端模式。 您可以將 GPI 設定為 PullUp或 PullDown狀態。 拉高電阻用於定義當 GPI 接腳未 受到外部驅動,或當外部驅動器在幀 擷取器之後才通電時,該接腳的電壓水準。若連接了外部驅動器,其驅動能力必須足夠強大, 才能克服 20 kOhm 的拉高電阻。 FrontGpiPullControl03參數 用於控制 GPI 群組通道 A(GPI 引腳 0–3)的運作行為,而 FrontGpiPullControl47參數則用於控制 GPI 群組通道 B(GPI 引腳 4–7)的運作行為。 為了讓拉低電阻能正常運作,外部 GPIO 電源必須 連接至適當的連接器接腳(A 通道或 B 通道的 GPI 電壓輸入與 GPI 接地輸入)。
|
||||
| FrontGpiType03 / FrontGpiType47(imaFlex 2 Dual 100 平台) | ||||
|---|---|---|---|---|
| Type | 動態、靜態寫入參數 | |||
| Default | 單端 | |||
| Range | {單端、差分} | |||
|
此參數用於控制 GPI 接腳是以差分模式還是 單端模式運作。FrontGpiType03 參數負責管理群組通道 A(GPI 接腳 0–3),而 FrontGpiType47參數則負責管理群組 通道 B(GPI 接腳 4–7)。 在 單端 模式下,每個 GPI 接腳的訊號會 原樣傳入VisualApplets ,使得該群組中的所有四個接腳皆可 獨立使用。 在 差分 模式下,編號為偶數的 GPI 接腳 與緊接其後的奇數接腳會組合成一個差分通道, VisualApplets 。當差分模式啟用時,偶數接腳傳輸 差分訊號,而奇數接腳僅代表負對狀態, 可予以忽略。
|
||||
| FiberPortProtocol0 / FiberPortProtocol1(imaFlex 2 Dual 100 平台) | ||||
|---|---|---|---|---|
| Type | 靜態寫入參數 | |||
| Default |
QSFP28[0]:CoF QSFP28[1]:資料轉發 |
|||
| Range | {CoF, DataForwarding} | |||
|
此參數用於定義幀擷取卡上對應 QSFP28 埠的 光纖通訊協定。 埠 0 通常用於連接攝影機(CoF ), 而埠 1 則用於將資料轉發至另一台影像擷取卡。從屬影像 擷取卡的兩個埠通常均設定為 DataForwarding。 CoF 代表「光纖 CoaXPress」(CXP 3.0 標準)。DataForwarding是 Basler 開發的 用於幀擷取卡間通訊的協定。這兩種協定 均支援每通道 25 Gbit/s,因此每個 QSFP28 埠的傳輸速率可達 100 Gbit/s。 在特殊條件下,可將兩台 100 Gbit/s 攝影機連接至單一幀擷取卡 。此類配置需滿足特定要求 。 然而,幀擷取卡必須先進行預處理,並將 產生的頻寬至少減少一半,才能透過PCIe 將資料傳輸至 主機記憶體或GPU 。 PCIe 提供約 13 GB/s 的有效頻寬,而 單一 QSFP28 埠則提供約 12.5 GB/s。兩組 QSFP28 埠合計可產生 約 25 GB/s 的內部頻寬,若未經預處理與頻寬壓縮,此頻寬無法透過PCIe 傳輸。 此外,該板卡的 RAM 系統對可同時透過 RAM 傳輸的資料量施加了進一步的限制。 有關資料轉發功能的更多詳細資訊,請參閱《使用imaFlex 2 Dual 100 幀擷取卡進行資料轉發》。
|
||||
| DesignClock(所有 imaFlex 平台) | ||||
|---|---|---|---|---|
| Type | 靜態讀取參數 | |||
| Default | 312.5 | |||
| Range | [312.5; 400.0] | |||
|
此參數代表設計系統時鐘頻率(單位:兆赫)。 您可在VisualApplets 中,透過 「設計」選單下的「變更 FPGA 時鐘」選項來調整設計系統時鐘頻率。若設定較高的頻率(例如 135 MHz),可能會 導致時序違規。若發生此情況,請降低頻率。
|
||||
| DesignClock(適用於 mE5marathon 及LightBridge VCL 平台) | ||||
|---|---|---|---|---|
| Type | 靜態讀取參數 | |||
| Default | 125 | |||
| Range | [125;312.5] | |||
|
此參數代表設計系統時鐘頻率(單位:兆赫)。 您可在VisualApplets 中,透過 「設計」選單下的「變更 FPGA 時鐘」選項來調整設計系統時鐘頻率。若設定較高的頻率(例如 135 MHz),可能會 導致時序違規。若發生此情況,請降低頻率。
|
||||
| ExtensionGpioType(imaFlex CXP-12 Quad 及imaFlex CXP-12 Penta 平台) | |||||||
|---|---|---|---|---|---|---|---|
| Type | dynamic write parameter | ||||||
| Default | OpenDrain | ||||||
| Range | {開漏極、推拉式} | ||||||
|
此參數可讓使用者選擇 外部擴充 GPIO 連接器的電路類型。在推挽模式下,GPIO 會被 直接驅動。
|
|||||||
| FrontGpioPullControl(imaFlex CXP-12 Penta 平台) | ||||
|---|---|---|---|---|
| Type | dynamic write parameter | |||
| Default | PullUp | |||
| Range | {PullUp, PullDown} | |||
|
|
||||
| FrontGpioType(imaFlex CXP-12 Penta 平台) | ||||
|---|---|---|---|---|
| Type | dynamic write parameter | |||
| Default | 單端 | |||
| Range | {單端、差分} | |||
|
|
||||
| FrontGpioInversion(imaFlex CXP-12 Penta 平台) | ||||
|---|---|---|---|---|
| Type | dynamic write parameter | |||
| Default | 關閉 | |||
| Range | {開啟、關閉} | |||
|
|
||||
| PcieInterfaceType(ironman 平台) | ||||
|---|---|---|---|---|
| Type | 靜態寫入參數 | |||
| Default | 第二代 | |||
| Range | {第一代, 第二代} | |||
|
透過參數 PcieInterfaceType,您可以選取PCIe 介面 類型,從而設定所支援的 DMA 頻寬。 Generation_2(預設)代表PCIe 第2代通訊協定, 並提供3,600,000位元組/秒的頻寬。 Generation_1 代表PCIe 第一代通訊協定,並提供 1,800,000 位元組/秒的頻寬。 第一代設計所使用的 FPGA 資源略少。採用第一代設計時, 要讓小程式達到時序收斂要容易得多。 Generation_2 雖能提供最佳效能,但使得 小程式的時序收斂更加困難。為滿足時序要求, 可能需要進行多次佈置與佈線合成運算。
|
||||
| PcieInterfaceType(適用於 mE5marathon 及LightBridge VCL 平台) | ||||
|---|---|---|---|---|
| Type | 靜態寫入參數 | |||
| Default | 第二代 | |||
| Range | {第一代, 第二代} | |||
|
透過參數 PcieInterfaceType,您可以選取PCIe 介面 類型,從而設定所支援的 DMA 頻寬。 Generation_1: The applet only supports PCIE generation 1. Thus, the maximum DMA transmission bandwidth is ca. 900 MByte/s (1MByte = 1^10Byte). The DmaToPC operator is limited so that LinkParallelism x LinkPixelWidth needs to be <= 64 bit. Generation_2: The applet supports PCIE generation 2. Thus, the maximum DMA transmission bandwidth is ca. 1800 MByte/s (1MByte = 1^10Byte). The DmaToPC operator is limited so that LinkParallelism x LinkPixelWidth needs to be <= 128 bit. Generation_1 的實作所消耗的資源比 Generation_2 的實作更少。Generation_1 模式對於那些 不需要 Generation_2 的高頻寬,但資源有限的設計而言,相當有用。
|
||||
| GpioType(適用於 mE5marathon 及ironman 平台) | |||||||
|---|---|---|---|---|---|---|---|
| Type | dynamic write parameter | ||||||
| Default | OpenDrain | ||||||
| Range | {開漏極、推拉式} | ||||||
|
此參數可讓使用者選擇 外部 GPIO 連接器的電路類型。在推拉模式下,GPIO 會被直接驅動。
|
|||||||
| BuildTimeStamp(所有平台 - 隱藏) | ||||
|---|---|---|---|---|
| Type | 靜態寫入參數 | |||
| Default | 不適用 | |||
| Range | 不適用 | |||
BuildTimeStamp 是一個自動生成的識別號碼。它是一個 32 位元的時間戳記,可在執行期間從小程式中讀取,用以檢查 已載入的小程式與其執行 環境之間的一致性。 |
||||
| ProjectNameHash(所有平台 - 隱藏) | ||||
|---|---|---|---|---|
| Type | 靜態讀取參數 | |||
| Default | 不適用 | |||
| Range | 不適用 | |||
ProjectName 中的項目所產生的 32 位元雜湊值(選單「設計」,選單項目 「屬性」)。此值可在執行期間從小程式中讀取,以 檢查已載入的小程式與其執行環境 之間的一致性。 |
||||
| AppletUidHigh(所有平台 - 隱藏) | ||||
|---|---|---|---|---|
| Type | 靜態讀取參數 | |||
| Default | 不適用 | |||
| Range | 不適用 | |||
參數 AppletUid 代表一個 128 位元的數值。此 數值的最高 64 位元會以 AppletUidHigh 中的數值呈現。 |
||||
| AppletUidLow(所有平台 - 隱藏) | ||||
|---|---|---|---|---|
| Type | 靜態讀取參數 | |||
| Default | 1 | |||
| Range | {0; 2^32 – 1} | |||
參數 AppletUid 代表一個 128 位的數值。此數值的 低 64 位元會以 AppletUidLow 中的數值形式呈現。 |
||||
以下範例展示了 AppletProperties 運算子的使用方式:

![[注意]](../common/images/admon/note.png)

上一頁

